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In the begining... 


Sometime back in February of 1998, I woke up one morning from a nightmare. 
That nightmare was losing the last of my Lisa's. I've two of them, one has a 
floppy problem (still), the other works flawlessly. A few days before I did 
try to access the one with the bad floppy. When I did, I didn't see anything 
on the display so I tried to adjust the brighness. This resulted in a pop 
and that was the end of her 


It turned out that luckily it wasn't a power supply problem at all, but 
rather that the I/O board had gone bad due to a battery leak. The Lisa2's 
have a four pack of sealed NiCAD's to keep the info in the PRAM alive. After 
a few dozen net searches and lookin in The Processor I found that PreOwned 
Electronics had a few I/O boards left and I bought one. (Yes I know about 
Sun Remarketting, but I've left a few phonecalls and emails and nobody 
called me bacl.) This fixed the problem; I also ordered an 800K floppy drive 
as they didn't have any 400k drives left. After purchasing the drive and 
later the 800K upgrade kit I still can't get the drive to work.. must be 
either the ribbon cable or the motherboard or some other interconnect to the 
I/O board, but it's not the I/O board.. Whatever... 


Back to the nightmare. I had two thoughts. In a few years, due to 
environment, dust, heat, cold, or old age, eventually enough components in 
both my Lisas would fail, and I would forever lose this collector's item, 
this old unique grand machine, the grandma of the Mac and the first somewhat 
successful commercial GUI machine. 


The second thought of course was to build an emulator. That way, I could 


have a Lisa forever, everywhere. On my Windoze machines, on my Macs, on my 
Unixen, and maybe, if it's feasable, on my Newt2k. 
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I originally started lookin inside Inside Mac Volume 1 and 2 to find 
possible hadware that the Lisa and the Mac had in common, after all, I 
thought that since the Lisa could run MacWorks, it might be similar. Boy was 
I wrong! The Lisa's hardware is much more complex than the Mac's! 


For those who have never seen a Lisa: 


* A CPU board containing a 68000 clocked at 5Mhz (due to memory access 
issues,) a proprietary MMU, and a video state ROM which is really a 
hard to access chip containing only the serial number of the machine! 


* An I/O card containing 2 VIA 6522 chips for the Parallel port and 
access to the COPS 421 microcontroller to controll the keyboard and the 
mouse, as well as the soft power switch. (In the Mac, the mouse is 
software driven.) Additionally, the I/O board also has a 6504 CPU with 
it's own ROM to drive the floppies/twiggy drive. On older Lisa's 
there's also a socket for an Amd 9520 Math Co-Processor. 

* Up to two memory boards 

* Up to three expansion port slots i.e. dual parallel port cards for 
access to Profile drives 


To make things even more complex, there are special memory addresses that 
turn on or shut off various flip flops. For example a memory parity error 
detector, a video scan line interrupt, and the MMU. The VIA's are not 
identical in access. One lives in offset of two bytes, the other in an 
offset of 4 bytes. The 6504's 1024 bytes of memory is battery backed up 
(this is what the four NiCAD AA's on the I/O board are for.) The 6504's 
address space is available to the 68000, but in two byte skips as opposed to 
linearly. That is memory addresses 0,1,2,3 on the 6504 are 1,3,5,7 on the 
68000. 


The video circuitry is fairly simple - a dumb frame buffer that shares its 
memory with the Lisa's memory space. As such another memory area register 
can be changed to "page" through the various memory areas. 


Luckily, unlike the Mac, the Lisa's (68000) ROM isn't used for much except 
the POST (Power On Self Test) and booting. Though it is possible for a Lisa 
Operating system to access the ROM, the functions it would call are limited 
to reading blocks off the floppy or Profile. 


Yes, the Lisa does support at least three operating systems: Lisa 7/7, 
MacWorks (which with a bit of hardware an RAM can run upto System 7.5), and 
Microsoft Xenix (yes, Microsoft Xenix, not SCO: This was before Microsoft 
spun SCO off!) I've read on other web pages that there was a port of CP/M to 
the Lisa CP/M 68, but I don't have that OS. 


As to how I got started on the project: I went on the web and searched for 
Lisa and Emulator and found many web pages related to the Lisa. I eventually 
came across one that mentioned that David T. Craig had lots and lots of Lisa 
documentation, and so I contacted him. He's been an invaluable resource... 
This project would have been close to impossible without his Docs. I just 
wish more people took his example and saved any technical internal docs 
about hardware they may have. I wish to write a Xerox Star and/or Altos 
emulator, but I just can't find enough detailed docs! 
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Never saw a Lisa's guts? Check out my history page! 


How come there's no emulator to download yet??? 


Be patient! I'm still writing it! 


Here's the status so far: I've got quite a bit of code (mostly untested) 
done, and I do have XWindows routines for displaying the Lisa screen to a 
port. 


Good news: Paul Lunga's team from emulation.net/lisaworks has joined my 
project (or have I joined them???) and now has my sources. They're currently 
reviewing it and will work it with me, so this will speed up the completion 
of this project. 


To do/finish: 
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Implement vertical retrace irq, 

implement clock timer interrupt (sigalarm) and handler... 

Implement code to handle triggermessages and call a fn each time it's set 
rather than waiting. 

Also check Profile and Via code for leftovers. 

add floppy controller calls to MMU code! 

Do VIA1 & 2 Interrupts properly using new code 

finish SCC loopback test code. 


Project Status: 
I/O 
100% MMU CODE 


95% VIA1 (needs interconnects to COPS and Profile to be done, plus 
support for Parallel Port Card VIA's.) 


96% VIA2 

100% COPS 

100% Profile 

100% Floppy 

715% SCC 

100% Contrast 

75% Volume 

715% Sound tone 

100% Serial ROM # 

Misc: 

35% Imagewriter 
Modem 


AppleTalk (might do applenet card sim if I can get specs later...) 


CPU Emulator: 

99% 68000 opcode refrence templates 

70% CPU Generator code done. 

0% opcode refrence to code emulator, assembler/disassembler compiler 

10% Disassembler/Debugger (use symbols from ROM code and code from ROM in 
display...) 

10% 68000 Code Emulator 

35% IRQ Handler 


X Windows/OpenBSD Code. 


80% Display 
Endian issues 
SCC to serial port tty's 
Mouse Handler 
Keyboard Handler 
Fancy options: (toolbar, box o'floppies, animations, etc...) 
Ports to: 
OpenBSD/Alpha 
OpenBSD i386 
Irix 5.x, 6.x 
HPUX 10 
Linux 
Linux VGALib ?7?? 
SunOS / Solaris, etc... 
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MacOS Emulator Port 
SCC to serial ports 
Mouse 
Keyboard 
Fancy options: (toolbar, box o'floppies, animations, etc...) 
local floppy access to 400k and 800 lisa disks. 


Win32 Emulator Port + (Intel 95/NT + Alpha NT port) 
SCC to serial ports 
Endian issues, 


Mouse 

Keyboard 

Fancy options: (toolbar, box o'floppies, animations, etc...) 
Newton 2000 port - maybe... still considering it... will do if I can 

get a C compiler or Newt soup code translator... would be cool 


I've organized my code thusly: 


/ - lisaem 


/debug <-code for built in 68k debugger 
/docs 
/utils <-utilities and support tools (disk imagers, etc.) 
/host <-host machine dependancies (xwin, MacOS, Win32, etc.) 
/hw <-hardware emulator code 
/hw/lisa 
/hw 
/lisa 
/boards 
/cpu cpu board —- cpu emulator + support chips 
/io serial, parallel code, cops 
/mem (mmu code) 
/video (video driver + video state rom) 
/floppy 6504 emulator 
/slots via emulators 
/modem 
/printer <- imagewriter code 
/profile <- profile driver emulating 5, 10mb profiles 


* LisaWorks Project - They're working on the project with me 

* Apple History on the Lisa 

* UNM's Apple Hardware (scroll down to Lisa entries) 

* UNM again - but telling it to search for Lisa for you 

* Apple's Lisa Specs 

* Owen Ink: The Mac Bathroom Reader contains a chapter on the Lisa... 
* AppleWizards (see June/July issues) for Owen's Lisa History - updated 
from the Mac Bathroom reader 

A DejaNews usenet article (of many) about writing a Lisa emulator... 
read the whole thread for fun! 

X/Lisa Page 

Greg Cifu's Apple Lisa page 

Tom Stepleton's Lisa page 

Semaphore Signal! A Lisa zine that you can read! change the ss01 to 


* 


+ + % 
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ss02, etc to read the other issues. I think there's like 40 or so... 
Classic Computer page (a small paragraph on the Lisa) 

Good info on the Lisa's Twiggies 

Please don't do this to your Lisa! A LisaQuarium! 

The Heart of the Lisa 

Old Mac Software (run'em under MacWorks on yer Lisa!) 

The German Computer Museum 

The Obsolete Computer Museum —- Lisa Page 

Simon White's Lisa Page (has DTC's Lisa Legacy Paper!) 

Sun Remarketting (but when I tried to get Lisa parts, they didn't call 
me back!) 

Get the Look of the Lisa's windows on your Mac! 

Jim's Computer Garage 

A German page with info on the Lisa, translation anyone? 

Apple II History 

System Emulators in existence for Linux 

BSvc 68000 emulator and framework 


+ + FF FF HF HF 


+ + + FF 


Htt 
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